FAQ

How do I find answers in this Manual and FAQ?

Where do I find answers to questions not present in the Manual or this FAQ?

CF Search

How to request support and report problems if I cannot find the answer in resources listed above?

Users requesting help and support, must first provide, in a new Cruiser's Forum thread (appropriately titled), all necessary details with sufficient screenshots and attachments. Bare minimum:

  1. OS type & version
  2. Computer Equipment: Manfacturer & Model
  3. Graphics card: Manufacturer and Model
  4. Opencpn version and Plugin version: Must be from the official download page (unless you are testing)
  5. Description: What was done leading up to the problem. What occurred and what you think the problem is.
  6. Opencpn.log and Opencpn.ini or Opencpn.conf files attached to a post in thread as .txt, .doc or .pdf
    • If the file is too big you made cut log file sizes down to the last 2 or 3 starts of Opencpn.

How can I post a screenshot, large document or compressed file to the Cruiser's Forum

Copy opencpn.ini file to Clipboard.

Copy opencpn.log file to clipboard.

How to find all those files you are talking about? Hidden Files|

  1. Screenshots to illustrate the problem.
  2. Anything else you think will be helpful.
  3. Users who are certain they have found a bug (or have a feature request) may report it in Tracker after the bug has been confirmed by one other user.

How can I post a screenshot, large document or compressed file to the Cruiser's Forum?

faq-upload-files

  1. In the editing window, use the paper clip
  2. Or hit Go Advanced at the bottom, then under Additional Options select Manage Attachments
  3. A pop-up window will appear.
  4. Select your screenshot
  5. upload it (if you don't see “upload”, scroll right)

Attachments from “newcomers” are often landing in quarantine, and are reviewed by the moderators, so please be patient.

There are some size restrictions on various types of documents which will prevent upload (scroll down the upload file screen for more details. If your file is larger than these restrictions, rename them as noted below. For large zipped, txt or doc files we will often rename them in this way:

PDF size is larger, so we often use that. Then we note in the post to remove the ”.pdf“ after download.

Where is my log file?

Read this explanation - Getting Started

Where is my config.ini file?

Read this explanation - Getting Started

Where can I download the User Manual?

It is downloaded with the software, so use “?” icon and then “Help”! It is also available on the Website Download page Then scroll to the bottom under ARCHIVES.

How to find all those files you are talking about?

A big contributing factor to this problem is that Windows default settings hides system files, and also by default, don't show file extensions.

  1. These settings can be changed however.
  2. In XP go to My Computer →Tools → Folder Options -View. Mark “Show hidden files and folders” and uncheck “Hide extensions for known file types”.
  3. Other versions of Windows are similar, but may not be exactly like this.

Now you should find the files we talked about in the previous paragraph.

Is there a compatible Hardware List?

Keeping an updated list of all the devices available is virtually impossible.

  1. As long as your device is able to produce NMEA 0183, OpenCPN most likely won't have any problem understanding it.
  2. Rather than looking for a list, which can't contain everything, ask in the support forum whether your equipment of choice is likely to work with OpenCPN before going shopping.
  3. If still looking for lists, you may like the following links
    1. Information about connecting various devices to OpenCPN:Supplementary hardware
    2. Radars for OpenCPN: Radar Overlay

Can OpenCPN receive multiple data streams from a USB hub?

In Options > Connections > Fransom GPSGATE virtual com port not seen.

In Connections > NMEA Data Window can an atypical message type be filtered?

Is there an ipad or iphone version of OpenCPN?

Trouble with Installation, finding Charts, and connecting GPS & Instruments.

  1. Installing Charts with Chart Downloader Plugin Chart Downloader
  2. Installing GPS GPS Setup and Status
  3. Instruments - Devices must provide NMEA 0183 data via Serial or Network with a range of protocols and settings available. The description for connecting to hardware is in the Options > Data Connections section. Connections and for additional assistance NMEA Sentences
  4. Also read Supplementary Software which has information about using an Android Phone's GPS, etc.

Serial interface for NMEA0183 input -AIS data & navigation instruments- switch without reason

  1. This is an OS problem. your OS starts numbering with the first device coming up, and this is not always happen in the same sequence. The good news is you can tell your OS to give an fixed name to a fixed device, and you can use this fixed name in OpenCPN. see:
  2. Or use Openplotter and its “serial” for the same purpose :)

Flatpak Data port connection issues?

See CF Dataport Connection problem There are some things related to serial data ports, in particular on Flatpak. * There is a bug: https://github.com/OpenCPN/OpenCPN/issues/2528- * The port must be accessible. See https://github.com/OpenCPN/OpenCPN/blob/master/LINUX_DEVICES.md, the chapter on Device Access. * Even if the port is accessible it might not be visible in the UI. Two solutions. * The first is to write the name of the device, perhaps something like /dev/ttyUSB0 in the GUI (one don't have to select from the drop-down list, it's possible to enter the device name as well) * The second is to create a device link as described in https://github.com/OpenCPN/OpenCPN/blob/master/LINUX_DEVICES.md, the chapter on Fixed Device Names. Such links are visible in the GUI

A new point Flatpak point fix has been pushed for this issue. To update the Flatpak installation do

Code:

<alt2> $ flatpak update org.openpcn.OpenCPN </alt2>

Note that despite the patch, devices must still be accessible as described in https://github.com/OpenCPN/OpenCPN/b...NUX_DEVICES.md

Where are the Chart Buttons "Piano Keys" at the bottom of the OCPN screen?

If the screen view is not in a place where charts are located then it will not show any chart keys. Try zooming out until piano keys show up.

Too many Chart Keys "Piano Keys"?

Check your Options→Display→Advanced→“Chart Zoom/Scale weighting” For most vector chart the level would be “0”. If for example “5” the chart bar will be crowded and poor performance.

Chart Keys - Why and When

  1. Only the charts belonging to the chart “family” viewed at the moment are highlighted.
  2. You've three families; CM93 yellow, ENC green and rasters blue.
  3. I you show CM93 charts neither of the other two will highlight.
  4. If you show a raster chart only other rasters will highlight on mouse over.
  5. The same goes for highlight of ENC cells.
  6. Consequently will a ENC not quilt with a raster chart at the same time, or vice versa.
  7. But as a kind of inconsistency will a raster quilt with CM93 if no rasters are available beside another raster chart. Very handy!
  8. To swap chart family to be shown you have to click a chart bar belonging to desired chart family.

Why are chart sections missing from the display?

If you are actually asking why you don't see the chart cell adjacent to the one being displayed as well, it is because you have disabled quilting and are in single chart mode, to switch back, press “q” or use the hamburger icon in the lower right corner to invoke the chart canvas options menu and turn quilting back on.

Why doesn't OpenCPN recognize "localhost" as a source?

On Rpi I type Telnet localhost 10110 I see the stream of NMEA 0183 sentences coming from the Signalk Server. Apparently OpenCpn does not work that way.

OpenCPN does not recognize anything other than Q4 notation in the address field. “localhost” is a semi-standard shorthand notation, used on many systems and apps. In OpenCPN, Instead of “localhost”, use ip of 127.0.0.1. It is the same thing.

OpenCPN crashes, what should I do?

  1. It is highly unlikely that uninstalling and reinstalling OpenCPN is going to resolve anything, really. But if you can't resist the temptation, help yourself, it is equally unlikely that it makes the things worse.
  2. You should have a look into the logfile to find out whether it contains some clues that could help isolate the problem. If the crash is related to displaying a chart, try to isolate on which one and create the simplest possible scenario we could reproduce. You should try to get fresh charts.
  3. You should try disabling OpenGL if it is enabled or vice versa.
  4. While OpenCPN is not running, move the complete data folder (C:\ProgramData\opencpn on Windows, ~/.opencpn on Linux ~/Library/Preferences/opencpn / on Mac ) to a backup location and see whether something was rotten in your local OpenCPN data. Do not delete it if you want to keep your waypoints, routes and tracks!
  5. If on Linux, run opencpn from command line and see whether it produces a backtrace to help identify the cause of the crash.
  6. Still on Linux, you can use gdb or another debugger to get the backtrace and help identify the cause of the crash.

OpenCPN 5.2 Dual Chart View not working properly.

    (C:\ProgramData\opencpn\)opencpn.ini:
    [Canvas]
    CanvasConfig=0

* Close O. Set the CanvasConfig like above. Save the change. * Try:

  1. The above a test to “clean up” the -ini file for the new version.
  2. If no success - rename/delete the ini file for a clean first time start up as of your own suggestion. (And, yes, that's a good training to reset all O settings. )

Why is recently updated OpenCPN performing badly?

  1. Look in the opencpn.log file. Try closing Opencpn, deleting the opencpn.log file and then reopening OpenCPN to create a new log file, then use Opencpn to cause the trouble again. Then look at the Log file to find messages that are associated with the problem.
  2. Verify the problem is not from an old and outdated opencpn.ini file. Rename your opencpn.ini file for possible reuse later, and restart Opencpn to create a fresh new opencpn.ini file. Test for the problem.
  3. Do you have Chart Display problems? Try turning on or off OpenGL and Running update of the Chart Database.
  4. Do you have a problem with paid charts? see Oesenc or ocharts.
  5. Do you have old plugins? Disable and uninstall all external plugins with the plugin uninstall program. Test OpenCPN and then download new updated plugins and install them one at a time and test.
  6. Final Resort: Try starting over by uninstalling Opencpn following this approach.
    • Go to the ProgramFiles “OpenCPN” folder, and use the uninstall programs, preferably starting with the plugins, and ending with the OpenCPN.
    • Check that the “opencpn” initialization folder of program data has been removed. Otherwise, do it manually.
    • Use the CCleaner software to clean the PC Windows registry in particular. (option)
    • Download OpenCPN again and all the plugins you need.
    • Install OpenCPN.
    • Run OpenCPN to verify that the operation is correct.
    • Install, one by one, the plugins you need.
    • Run each plugin before installing another one

Charts used to show, but using 3.0.2 and later, they no longer work.

  1. OpenCPN used to display charts with an unknown projection as a Mercator chart. The same thing applies to an “UNKNOWN” or not recognized geodetic datum, where OpenCPN used to default to WGS84.
  2. This is no longer the case. If OpenCPN don't recognize the chart projection, it will not be displayed.
    • Potentially serious errors are thus avoided.
    • The event is logged in the opencpn.log.
    • Users may run into problems if a chart projection is stated as “UNKNOWN” even though it really is a prefect Mercator chart.
  3. Unfortunately, some conversion tools take a shortcut and don't enter the “PR” tag in the kap-chart-header correctly.
    • The projection of a chart can always be found, and the “PR=UNKNOWN” should always be avoided.

Official charts that OpenCPN really can't display, with a latitude < 70 degrees north/south, are very few indeed. Really only a handful of legacy, Gnomonic, large scale charts. Charts with “UNKNOWN” or blank geodetic datum are best avoided, they may be dangerously inaccurate.

My charts "Senc" files are growing bigger and bigger (1.5gb). What can I do?

Anything in the SENC directory may be deleted while OpenCPN is stopped. The required files will be recreated as needed.

KAP files can be zoomed in but zoom out (with scroll wheel or the +/- buttons) and the chart reverts to the CM93 background

Turn quilting off (keyboard “q”) and you can zoom in or out as much as you like on a kap. I have a lot of overlapping charts including vector types and this is what I do, or as cagney says, the chart will change per zoom..the which is fine unless you want to stay on a particular chart. Another way would be to set up “Chart groups”…

I have a problem so I reinstalled, but that did not help.

- Try this approach instead - Troubleshoot Installation

GPS: A stupid question. When a GPS position is used as a waypoint to goto, is it using a great circle route?

When you “Navigate to” a waypoint from OpenCPN, he does the following:

  1. Create a temporary route from current position to selected point. The route has only two points, start and end.
  2. Activate that route.
  3. If a suitable output connection is available, he sends the following NMEA messages periodically to that port.
    • ECRMB
    • ECRMC
    • ECAPB
    • ECXTE
  4. The Cross-track error (XTE) output by OCPN is calculated as for Rhumb Line Sailing, i.e. straight line on Mercator chart.

If an autopilot is steering the boat, it may choose to follow GC route if it wants to. The current GPS position and the target waypoint position are available in the messages sent above.

If the A/P uses only XTE, then it is sailing Rhumb Line. Alternatively, if it ignores XTE, and computes a running GC course based on the target waypoint location and current ownship position, then it is doing GC Sailing.

If the A/P is doing GC Sailing, then you would see the XTE reported by OpenCPN diverging from zero, as expected.

Of course, other chart plotters may do this differently from OpenCPN.

Personally, I wonder why we care. Rare indeed would be the case in which a two-point route long enough to benefit from GC Sailing would be traveled without need to change course for other tactical reasons (weather, traffic, etc.). Could happen with a large motor vessel, I suppose…

Users generally prefer rhumb line because

GPS is not found by OpenCPN, but my GPS is working!

The GPS is working, why aren't COG & SOG working?

Two GPS, COG & SOG values change and are wrong and right?

GPS Program (EG: Delorme Earthmate LT-20) is recognized by Win10 and position is shown, but OpenCpn Connections does not have a GPS Comm Port available

If you can “see” your position in the Win10 GPS Program, OCPN would also find it if you:

  1. Disconnect the GPS Device from any program using the assigned Com port.
  2. Connect OCPN to the same Com port using the correct baud rate.

See OCPN wiki how to find what Com port to use

GPS Puck only works sometimes. What is wrong?

How to increase (or decrease) rendering of Own Vessel position (GPS)?

Add a second GPS object to OpenCPN

One method used for several similar purpose is to transfer the information from xxGLL to a xxTLL message. OpenCPN will understand that as an ARPA target using the same functionality as for AIS targets. You can have a general Target number, e.g. 01, and a name, e.g. “My target” and fill with the position from xxGLL on every update. Set Status to “T” and nothing in the “Reference” field. See Cruiser Forum Thread

GPS is installed and I think its working, what next?

  1. Perhaps you'd like to download some charts? We suggest using Chart Downloader.

Activating route at desired waypoint?

  1. Activate the route first. Then you can activate a specific waypoint within it.

Many error messages when starting OpenCPN from Linux command line.

Messages like:

are quite normal and have nothing to do with OpenCPN. Just ignore them!

Toolbar is not visible in OpenCPN 4.8.4 and 4.6.0 under Ubuntu

Apparently sometimes Toobar works and sometimes not. When the toolbar is not visible, the problem is that ocpnToolbarDialog was created with very small dimensions. See Github Issue #820 for how to edit the config file.

How to increase the size, color and location for the Toolbar?

In Tools→User interface you can select to collapse the bar after a given time and further down adjust the size with the slider “User Interface scale factor”. Color and location are though not adjustable. Dark grey on black is OK at night but in bright sun the icons are just not visible. For the same reason, you can change the status bar default black text on grey to white.

Why doesn't the plugin work?

  1. It is best to keep OpenCPN and plugins updated to the most current version.
  2. If you are having trouble, it is likely you will be asked to update plugins and Opencpn to be current.

Where are Plugins Stored?

When will OpenCPN be ported to Android?

  1. There are two versions in the Google Play Store. We suggest you will be happiest with the paid version created by D. Register because it is updated regularly and is current. There is a forum at http://bigdumboat.com/aocpn/forum/.

Why do vector charts take so long to load?

  1. The behavior you see is expected for ENC charts. ENCs must be converted to internal SENC format before use for navigation. This takes a little bit of time, depending on your system capabilities. But it only has to be done once, and the converted SENCs are stored on your system for later use.
  2. All ECS systems must convert ENCs to SENCs. Some take longer, (like OpenCPN), so that subsequent access is faster. Some convert faster, leaving more work to do at the time of actual chart display. Its a design decision. OpenCPN is optimized for speed in real use, not for speed in conversion.

Why don't charts show at all zoom levels while quilting is enabled?

  1. If I turn off quilting, I can select the individual maps just fine and zoom to any level on them. No amount of clicking/hiding the maps using the map bar at the bottom of the screen show the maps. Only a zoom allows them to be seen. This problem of disappearing maps happens all over the country at different zoom levels.
  2. Answer: OpenGL is turned off. Without OpenGL, OpenCPN will not quilt Mercator and Transverse Mercator charts together. Try enabling OpenGL with Options (wrench tool icon)> Display> Advanced. Click on the box between “Graphics” and “Use Accelerated Graphics (OpenGL)” to put a checkmark in the box.
  3. When OpenGL is enabled, OpenCPN will quilt Mercator and Transverse Mercator charts (and some other projections).
  4. If “Texture Compression with Caching” is enabled under “OpenGL Options” there will be a delay before each chart is displayed for the first time. Subsequent display of the charts in the cache will be faster.

Whenever a specific chart is opened, OpenCPN crashes. What's going on?

What are all those 'U' s or '*' astericks in triangle all over my Vector Charts?

On the water areas, there are triangles shown with a varying number of stars inside them. What does this represent and is it possible to avoid the triangles being shown?

Most users just want to get rid of the triangles, but please refer to the Quality of Data Documentation.

  1. In Options > Charts > Vector Charts Tab when using Display Category “All”, Uncheck “Chart Information Objects” which hides the “U” symbols .
  2. In Options > Charts > Vector Charts Tab for a finer grain control when using Display Category “Users Standard”, In the selection List Box, Uncheck “Quality of Data” which hides the “U” symbols.
  3. If Quality of Data is checked, then the Shortcut Key “U” should toggle the “U” symbols on and off. See Keyboard Shortcut

Also, when viewing ENC charts:

  1. “U's” show up all over the charts
  2. Text detail seems to be missing ..like buoy identification ..Bridge names and clearances etc…
  3. Depth sounding seem to disappear zooming in and out.

Hit Text: The A+ button. To show text.

Why is "Users Standard" greyed out?

Options > charts > Vector chart display tab, the 'user standard objects' section on the right side is disabled, items cannot be selected and the list cannot be scrolled. This is expected behavior.

Cruiser Forum: User Standard Objects not available

How to show Cables Underground and Anchoring Information?

Submarine cables are enabled by Hamburger→Display Category (All or UserStandard) and CheckBox “Anchoring Info.”

How to remove those pink crosses (isolated danger symbology)?

This isolated danger symbology is a part of the new ENC S57 presentation standard which OpenCPN complies with, get used to it. OR You can try to cover them with your depth setting. Look at the manual Vector Display Tab > Shallow, Safety & Deep Depths Safety Contour”, where you will find an example of just how depth is taken into account when displaying the magenta cross.

How to hide the isolated danger pink circles

We have three setting for depths. They can be used in different ways but my boat (1.7 meters depth) and own philosophy gives this: * Shallow: 2 meters > Dark blue: keep out. * Deep: 3 meters Light blue; be careful. > Deeper water is white and safe. * Safety Depth: 5 meters to get highlighted soundings where I should not anchor due to weed/grass and to get rid of unimportant isolated dangers. The isolated danger indicators are shown or hid based on the safety depth/contour setting.

The traditional approach is to set the shallow contour to the “will run aground” depth, while the safety contour is calculated from your draft, safety margin, and height of tide. The deep water setting is then used however one likes, e.g. to mark areas shallow enough to anchor in.

Since the contours defined in the charts can be deeper than the value you select (the computer rounds up), it's possible that you sometimes will need to cross the safety contour. That's why soundings shallower than the value you enter will appear in black font, to make the hazardous ones more visible.

Thus, the simplest way to make the isolated danger marks disappear is to adjust the safety depth/contour to be deep enough.

You may wish to do this anyway, for example what I consider a safe depth within a bay is different from what I may consider at sea. The Potato Patch Shoal outside SF may be 7-9 meters deep, but that doesn't mean I consider it safe water.

Cruiser Forum Thread

What is this chart object symbol (magenta circle with X)?

It is the Isolated Danger Symbol, used to flag rocks or other hazards that are in otherwise “safe” waters as defined by your safety contour setting, but still have a depth less than the safety settings.

CF Thread

How to adjust depth shown in shallow waters in ENC & Vector Charts

Go to Toolsbar > Options > Charts > Vector Chart Display. Change the settings:

Then your soundings on vector charts ar well visible and not faint up to 50.00 metres.

Why don't the vector charts have text names on country, towns, harbor, ports, bouys and waters?

Chart text can quickly be hidden/shown by the key “T” but be sure to have correct text options checked, see below. Alternatively click on the “A+” Icon in the toolbar.

Options (gear) > Charts, Vector Chart Display and Uncheck: Important Text Only, De-Cluttered Text, Reduced Detail at Small Scale. Then using the chart menu at the lower right of the chart select “Display Category” to “All”. Then check all the boxes under the heading Vector Charts. You will have more text than you can read.

If still no joy, make sure you do not have the texts disabled in the configuration Options > Charts > Vector Display Tab. Also see Chart Text Settings.

Vector Display

Declutter Text

Why are certain ENC toggle states not remembered or persistent - Shortcut "L" Lights and "A" Anchoring

Lights and Anchoring Info always start up activated, whereas Text and Soundings state is remembered. This is intentional. If there is no text or no soundings you will notice there is something missing. For lights and anchor it is not always easy to be aware if it is on or off, so for safety the default is on. If you like a default off, use “Users Standard” and switch the lights and seabad features off (but this is not a recommended state). See Keyboard Shortcut

Why are Vector Chart Daymarks ghosting?

The Charts American ENC NOAA charts. The chart advises OpenCPN what symbols to be used and where to put them. Inspecting the chart usually yields the answer. For example At blake island the entry to the marina is coded as ObjectClass:

Beacon, lateral
Acronym: BCNLAT
Where as
Buoy, lateral
Acronym: BOYLAT

This is the common way for a chartmaker to code the chart.

Also at Blake island the topmarks are coded as

Daymark
Acronym: DAYMAR
while the common way is:
Topmark
Acronym: TOPMAR

What you see is the way the chartmaker intended it, or the chartmaker was an apprentice wo messed things up.

Answer: Using Options → Charts → Vector Charts this is the correct display when using “Simplified” chart feature display. If you switch to “Paper Chart” feature display, you will see the more familiar images for the topmarks.

4K Displays Other Settings

What are those black regions associated with ENC CM93 shipping lanes near Gibraltar?

  1. The black regions never seem to go away, but change the Vector Chert Setting, “Boundaries” from “Symbolized” to “Plain” and the problem is resolved. These may be hatched/plain areas when changing the settings, or perhaps some national water delimitation is drawn plain or fine-dashed (Gibraltar).

Many of my Navobjects and waypoints disappeared. Why?

  1. Try using the “V” shortcut key which shows/hides Hides/shows all navobjects. The only exceptions being the active route and track which are always drawn on the chart canvas.

Kap files are no longer displayed correctly. Why?

  1. Old versions of OpenCPN were correcting broken KAPs on the fly. (They work on 3.2 but not on any 4. release ) The new ones don't do it anymore as the number of damaged charts circulating around decreased significantly and we gained some extra performance during chart loading. Refer to these sections of the User Documentation too.
  2. Chart Conversion Manual Specifically libBSB and ImgKap and Kap files.
  3. To fix your charts, run bdbfix on them.

What causes spurious waypoints which must be deleted?

  1. Condition: Multitude of repeated waypoints, which get copied when a waypoint is dragged. Sometimes a route WP is shifted, two routes are made, one with the name, the other unnamed.
  2. Possible Solutions: Determine if the addition of waypoints are from inadvertently hitting the wrong keys on the keyboard, or the mouse.
  3. The other possiblity is that the navobj change file is corrupted. Close O and try to delete the change file In W8.1 it is found in C:\ProgramData\opencpn/navobj.xml.changes. Normally, after that O will work again.

What causes random waypoints dropped at the cursor

One possibility is that you have the space-bar set to drop a wpt at the boats position. This used to be standard behavior some time ago. If this is a problem, shut down OpenCPN. Open the file opencpn.ini, find the line:

 SpaceDropMark=1  and change it to   SpaceDropMark=0 

Save and restart O.

What happened to zoom to cursor?

Can I use my Seaclear wci or OziCharts?

See Use-seaclear-wci-charts and Oziexplorer to Opencpn Also see Not supported formats that can be converted and Map2Kap and WCI Charts

How to import Routes?

  1. Receive waypoints in GPX-file from an external source which are arranged in the intended travel sequence. However, the GPX doesn't include direct routes between those waypoints.
  2. Import the waypoints to OpenCPN and the order in the Waypoint and Route Manager is correct.
  3. How to create a direct route between those waypoints in OpenCPN automatically without editing the gpx-file?
    1. Best way to do this, by “forcing the text file to be generated as route points”, then generate Route from track in the Route & mark manager.
    2. Manual Route creation by Start route creation. (Ctrl + r or right mouse click menu), Then click first WP and accept “Use nearby WP” and so on.
    3. GPS Babel may help you out if the handcrafting feels annoying.
    4. Use a Text Editor to form the xml list of waypoints into a route to conform to the xml format.

<CODE> <rte>

  <name>test2edit</name>
  <extensions>
     [DATA}
  </extensions>
  <rtept lat="57.679627692" lon="11.796954074">
     [ROUTE DATA]
  </rtept>
  <rtept lat="57.679627692" lon="11.796954074">
     [ROUTE DATA]
  </rtept>

<rte> </CODE>

Can I import SeaClear routes and waypoints into OpenCPN?

Can I import Maxsea Waypoints and Tracks?

No, not directly, they are in different formats. But you can convert them with the GPS Utility Program. Here's an older writeup Conversion of MaxSea Routes and Tracks Use an external tool to convert the proprietary Maxsea data to the open GPX format. Either the free C2GPXKML or shareware GPSUtility could help. Also if you have access to Maxsea, export all waypoints as Gpx and OpenCPN will read the gpx file. If different color waypoints is used, export them separately and and in a text editor change icon name to an icon used in OpenCPN.

Can WPL Nema waypoints be imported?

See CF Adding waypoint from outside OpenCPN

Yes the NMEA WPL can be handled by OCPN but not the way you may want.

How to synchronize Routes, Waypoints & Marks with another computer?

Three ways to synchronize:

The navobj.xml file resides in the same folder as the opencpn.ini settings file, under the OpenCPN User folder. For windows this is usually “C:\programdata\opencpn\”. The navobject.xml file is in in fact a .gpx file containing all waypoints/routes/tracks. See Navigation Data Backup for more information.

Make a script or batch file to copy to navobject.xml file. Make an icon for the batch file on your desktop. Examples: Make an icon for the batch file on your desktop.

Copy-Routes-AB.bat

Copy \\ComputerA-name\C:\ProgramData\opencpn\navobj.xml \\ComputerB-name\C:\ProgramData\opencpn\navobj.xml

Copy-Routes-BA.bat

Copy \\ComputerB-name\C:\ProgramData\opencpn\navobj.xml \\ComputerA-name\C:\ProgramData\opencpn\navobj.xml

For more discussion see Cruiser Forum Thread Real-time sharing waypoints and routes

Can I restore my Route, Wpts or Track from backups? Somehow?

If you did delete the original [route, wpt, track], you may still have an automatic backup in an older navobj.xml.[1-5] file. Don't restart Opencpn again, until you retrieve the data you want. See Navigation Data Backup for more information.

Why are Routes, Tracks and Anchorwatch not saved?

This problem has been traced to shutdown management. Please see Tracker FS#2245 and OpenCPN and Linux powerup/down management For Windows and MAC users it is suggested that it is best to shutdown OpenCPN first, then shutdown the Computer.

Split a Route

Question: How to split a long route into shorter segments with each segment having its own start and end waypoint? When the split function is used, I get a new route name with an _B suffix, but it's still physically “connected” to the original route (now with a _A suffix) with a segment line connecting the two. I want to end up with two distinct routes that are not connected. How do I do that? Answer: The point where you did split the route exists now twice as start of one and end of the other route. Just hide one of the two routes and move the waypoint you are interested in as you like. Or insert additional waypoints and delete the first one.

The quick way to change the ScaMin value (ov50 feature) for a lot of waypoints and/or layers?

Waypoint Name: Waypoint properties names box is unchecked. Quick way to checked globally?

So that the names show up beside each waypoint as it is placed? There is not a very easy way, but one at least much easier then you do now.

  1. Run O open the routemanager and select and export the routes you want to change.
  2. Then open the exported route(s) in a editor (notebook?) and do a text find and replace.
  3. Search for “<opencpn:auto_name>1</opencpn:auto_name>”
  4. and replace with “ <opencpn:viz_name>1</opencpn:viz_name> <opencpn:auto_name>1</opencpn:auto_name> ”
  5. Close the editor, run O again and import the altered route(s).

Now you should have all waypoint names visible.

I converted a Track accidentally to a Route. Can I get the track back?

This depends on what “a bit ago” actually is - (if you have since started OpenCPN more than 5 times, every time did some change to the navigation objects and did not change the default settings for backups, you don't have it anymore) - If you do not have that backup anymore, you may still export the route as GPX file which you may later edit in a text editor and make a track again (But you already have lost some precision as during the conversion to route the points recorded in the original track are interpolated to limit their total number) - Later: your track seems to still be there as the yellow highlight it has seems to be visible, so you should be good just deleting the route.

Export Selected Tracks, only last track appears to be selected in GE?

When you export multiple routes or tracks in one operation they are all written to a single GPX file. That might be why you think only the last one is being exported. When you import the GPX file all the routes or tracks it contains will be restored. Note: In GE the Track looks strange, although all are marked visible, only one track at a time is shown.

Imported Routes, How to remove duplicates easily?

Deleted all routes in the Route & Mark Manager. Found a gpx Route File folder under documents on my computer. Importing all gpx routes into Route & Mark Manager from Route folder by highlighting all the routes. Now multiple routes with the same name show. How can I correct this. Importing a route at a time is tedious.

I had previously exported all visible routes and had that file in my GPX Route folder. What happened: I imported single listed routes by highlighting all the files in my GPX Route folder. However I didn't notice the gpx file which had a group of routes contained in it. Once I removed the gpx file with a group of files, the import gpx worked as anticipated.

What is the utility or purpose of the GUID box on the waypoint extended properties page?

The GUID box is not useful for anything but knowing the GUID. Knowing the GUID is good to be able to find a specific object in OpenCPN's GPX data when processed in a text editor. Doing things with OpenCPN's GPX data in a text editor is something you normally don't do, but when you do, you are most happy that you know the GUID of a certain object.

Why is own ship pointing towards COG instead of directly towards the bow, and there is no magnetic heading?

Enable thw WMM World Magnetic Model please.

It makes no sense to use magnetic on true north facing mercator projections.

Ownship true north heading predictor is only displayed if true north value is available.

If HDT is not available in the nmea data stream we use HDM and variation from the WMM plugin to estimate an effective HDT.

Options > Connections "Show NMEA Debug Window" is Modal

Linux & MacOS Issue: Check display of the “NMEA Debug Window” and the “Connection window” simultaneously causes “Pause” and “Copy” to be are inactive. The connection window has to be closed first, then Pause works.

The Options window, in which the Connections are displayed, is what is called a modal window. Everything else is blocked until that window is closed. Modal windows make for simpler programming, which is why they are used.

For examining NMEA sentences, you could consider the MessageNMEAsampling script for the JavaScript plugin. It samples NMEA for a period and then reports what sentences have been seen together with their counts and then prints one sample of each. You can also configure it to display all of the sentences you are interested in. This is much easier than trying to tame the rush of sentences in the debug window.

Jumping and Uncontrollable Mouse with Win10 and USB hub

See this CF Thread

  1. Solution 1: No need to edit registry. Works for all versions of Windows.
  2. Open device manager. (usually through control panel.)
  3. Expand “Ports (COM and LPT)”
  4. Right click on the port that is messing up the mouse and click properties.
  5. Click Port settings→Advanced and turn Serial Enumerator off.
  6. It should be ok to turn Serial Enumerator off on everything except the actual mouse.
  7. If the mouse not working, how can it be possible to do the above? Good question: Do this when the effect is intermittant.

Solution 2: Disable Serial Mouse Detection

Jumping GPS!

Best to analyse the data stream with the individual xxGSV sentences etc. to understand the issue better.

Physical Changes

AIS is not involved

GPS AIVDO Boat Position is Jumping many miles away.

Charts jump while Using Follow Ship Offset, Look Ahead & North up Modes

Chart Rotation Smoothing. When follow ship, offset mode, look ahead mode and north up mode are all turned on, the goal of the look ahead is to position the ship about 2/3 away from the farthest point directly ahead of the ship. Because the screen is a rectangle, the ship's position on the screen keeps changing, since the farthest point ahead is changing rapidly. Use Options > Display > Advanced Chart Rotation Averaging Time [new title] or Course-up Update Period _Time [old title] to smooth the chart rotation. It is actually another “always on” COG filter that smooths VP rotation and makes the chart much less jumpy. In conjunction with NMEA course and speed filtering the chart moves slowly in a nice way. Chart rotation averaging time“ set to at least 15 sec.

Why is OpenCPN slow?

Why is ENC Vector chart display slow?

Scroll-to-zoom is unusable

Behavior: Expected -chart zooms in / out ONE level Actual -chart zooms in / out a crazy amount; mouse zooms 10 levels in / out Turn on Options > Display > General > Smooth Panning/Zooming

Auto Follow won't work

Very Choppy Chart panning after "Navigate to Here"

Disable Options > Connections > “Output this port (as autopilot or NMEA repeater)”, particularly if it is doing nothing. Once I unchecked the issue goes away.

Why are Mouse zooms very sensitive and hard to control?

The scale jumps appear very large. I have looked but cannot find a pref or other setting. It may be due to the scales of raster charts.

User Interface, Ship icon, AIS icons, Chart Objects and Depth Soundings are the wrong size or scale factor

How do I adjust scale factor for Ship and AIS, Chart Objects and the User Interface? Adjust the Three Scale Factors Adjust how large the User Interface is. Adjust how large Ships and AIS symbols are. Adjust how large Chart Objects and vector depth sounding are.

Why are Own Ship Icon and AIS targets very small after upgrade?

Solution: Set the AIS targets to be shown scaled, in Settings > User Interface and near the bottom are sliders for scaling items. Use ship scale at 2 or 3 gets a nice sized AIS target. The Scale sliders were added for greater user control in the new version.

Tried the following:

  1. Check setting Tools→Display→Advanced→Physical screen width. If not already Auto select that and Apply. Now read the mm value and compare to your screen width. If it does not conform, change to “manual” and enter your actual size.
  2. Changing options such as “Ship icon type” and can get the ship icon back to readable size by changing the option from default to Real Scale Bitmap and setting the mm size to 30 but this does not change the AIS target size.
  3. Checked setting for “Physical screen width”. Tools→Display→Advanced→Physical screen width. If not already “Auto” select that and “Apply”. Now read the mm value and compare to your screen width. If it not conform change to “manual” and enter your actual size.
  4. Show AIS targets as real size does not help.
  5. Note: The external monitor can be forced to display the correct sized icons by first enabling both the laptop display and the external monitor and then disabling the laptop display.
  6. Also check Settings→Display→Advanced→Physical screen width. Does it match your actual device screen width in mm? When set to “Auto” the default Icon sizes should be reasonable when the Scale sliders are set to around 5 (midrange). See Settings > User Interface and the three Scale Sliders at the bottom here Adjust the Three Scale Factors

How are font sizes for vector chart Depth Soundings adjusted?

Out of the box, the “Depth” notation is unreadable.

How are fonts adjusted in the User Interface?

This Leg text font is too dim

How can all font sizes be easily changed to a better size?

How are fonts adjusted for the AIS Target List?

AIS Target Range and bearing does not work in a stationary operation?

OpenCPN requires a valid ownship GPS location to calculate range and bearing to AIS targets. It was not designed for stationary operation to monitor live AIS traffic without GPS input.

If you insist, you may use VDR plugin, by running a text file with a single GPRMC nmea sentence describing your homebase location, repeated over and over….this will work, try this in a text file:

$GPRMC,180000.000,A,4221.0000,N,07106.0000,W,0.00,180.00,101017,,,*3E<cr><lf>

AIS Targets HDG and COG may be wildly different

The TRUE Heading reported in the target query is always as actually reported by the target. We do not apply variation to that value before presentation. So, what you see is no error. Of course, in situations with strong cross currents, or maneuvering, the reported HDG and COG may be wildly different.

AIS Target List does not show range

A valid GPS data input is required to produce range and bearing data for AIS targets. It will not use the “move boat here” coordinate. You can use the VDRplayer plugin and a previously recorded file to test this.

Why is AIS target mouse rollover info is not shown?

Make sure that Options→User Interface→” Enable Route/AIS info block“ is ticked before you spend more time on the issue. This is a new option. One reason for the new option relates to touch-screens. Since there is no concept of “mouse hover” on a touch screen, the “rollover” can only be activated when the user touches the AIS target on screen. On the other hand, the user also touches the screen to move the chart,zoom, etc. Some find that having these target rollover boxes pop up willy-nilly can be distracting. So, we add a method to turn them off.

How can a SART Alarm be disabled or ignored?

MOB SART has been tested extensively. The methods for deactivation should work. See SART. Also Disable SART When Alert is active, find the Alert's MMSI number in the AIS Target List. Then Add a “New” MMSI number in Options→Ships→MMSI. Then Edit the Options→Ships→MMSI Properties to “ignore” this target. Then close the Options Dialog. Then “Acknowledge” the SART alert one more time, and no further alerts will be seen. If you restart OCPN, you will never get alerts for this target again.

How can an AIS alert be disabled, blocked or ignored?

How to block (filter) the AIVDO sentance?

See Ships Icon fluctuates AIVDO is the “ownship” sentence. It contains position information. My own AIS does not send one, it sends RMC and a GG? (there are a couple). Don't know why, some programmer's selection. You can confirm in the NMEA Debug window. Removing it is under Options|Connections. For each connection you can filter sentences by checking either the “Accept only sentences” or the “Ignore sentences” option, then put the sentence names in the filter box below (if the filter box is empty then this is ignored). You can use the ellipsis (…) to the right of the filter box to get a list of sentences. This is easiest if you run the debug window, then you can see what sentences you are receiving and accept/ignore those you want to filter.

What is the MMSIname CSV file for?

The file aids with faster display of vessel name, until first static information message is received from that vessel, which then overrides the cached value. Usually found in your user folder, for Windows C:/program files (x86)/programdate/opencpn/ Please see the AIS section under mmsiname CSV

Can the MMSIname CSV be edited?

Yes, unless you break it. As it is created automatically, it is also safe to delete it. Please see Cruiser Forum post by Nohal for more answers.

How to send routes to GPS via USB or via NMEA Serial connection

There are so many GPS models that the answer is a bit complicated. A lot depends on which GPS model you have. OpenCPN can communicate with many GPS receivers via a serial connection. Some GPS receivers have a serial connector that can be wired to a DB-9 serial connector. Newer ones have a USB port that will appear like a serial connection to your computer. Still newer ones appear to your computer like an external drive.

If your GPS receiver shows up as a serial connection on your computer chances are you can upload routes and waypoints directly to it from within OpenCPN. The GPS and OpenCPN have to be set to the same communication protocol. If you normally have them set to NMEA (for updating the OpenCPN chart display with position data from the GPS) you may need to change a Garmin GPS to the GRMN proprietary protocol to upload routes, waypoints, and tracks. If your GPS doesn't show up as a serial connection you may still be able to transfer routes and waypoints to it outside of OpenCPN. If the GPS appears as an external drive on your computer try this. Use OpenCPN to export your routes and waypoints to a GPX file (read the User Manual section on the Route & Mark Manager for more details). Then use your operating system to copy the GPX file from your hard drive to your GPS. If that doesn't work, try GPSBabel or EasyGPS for the transfer.

Depending on your GPS model and the way the route was created in OpenCPN you may wind up with a route on your GPS or just a list of waypoints. The route points may or may not appear as waypoints on the GPS.

There are also some good Cruiser Forum threads about Garmin

Night time Mode Title bar is too bright in Windows

Windows: Dialog frame label not dimmed on Color Scheme toggle

Read this.

  1. Opening the properties page, and adding a link to a JPG-image works fine. If I now edit the link, the image will no longer be displayed.
    1. The button “Edit” changes state. You click on it to switch the links above to “edit mode”, each click on any of the links opens the dialog allowing you to change it's parameters. After editing the link, you have to click on the button again and then a click on the links will again start opening whatever they link to. What will happen when you click on the link is explained in the text below the buttons and changes according to the “Edit button”. If it says “Links are opened in the default browser”, the linked file or internet address should open, given it exists, which gets us to..
  2. Similarily, if I export a waypoint with a link to another computer, the link will not open.
    1. The link is just a link, the file you link to is NOT “included” in the waypoint. When you transfer the waypoints to another computer, for links to local files to keep working, the files you link to would have to exist on the exactly same place on your disk there. Eg. The file that on computer A is C:\MyDocuments\MyPicture.jpg would have to exist with exactly the same file name, in the exactly same folder, on the exactly same disk on computer B.

OpenCPN and Great Circle Navigation

  1. There is a Route Plugin for Great Circles.
  2. Raster charts display bearings and headings as straight, measurable lines on the chart. Similarly, Vector ENC's are rendered as Mercator projections in OpenCPN and most other ECS's for the same reason.
  3. For typical coastal navigation, errors which occur using rhumb line instead of great circle calculations are small for the distances usually covered by one chart.
  4. Mercator Charts and Mercator navigation is the standard for most navigational purposes. Other terms used instead of “Mercator Sailing” is “Loxodrome Sailing” or “Rhumb Line Sailing”.

OpenCPN 3.2.0 forward handles Great Circles directly

Mouse rollover feature becomes disabled

'Enable Touchscreen interface' in Options/User Interface disables the rollover feature on my PC with a touchscreen. With this setting enabled, touching a target displays the target information. Without it enabled the rollover feature works.

“Rollover” is a mouse thing. One does not exactly “rollover” with a touchscreen. This could get very distracting to the overall UI. Thus, rollover is disabled for touch.

OpenCPN with Touchscreen for RPI arm64

See FAQ above, OpenCPN supports some Touchscreen, however there is an totally independent development and special BETA version available that needs testing. See Cruiser Forum Thread Open CPN on a Touchscreen?

How to save Toolbar and Dashboard position?

  1. Start OCPN. Set the toolbar as you would like it. No dashboard visible yet.
  2. Grab a screenshot.
  3. Exit OCPN cleanly by closing the Opencpn window normally. Restart and the settings should be saved.
  4. Using the Raspberry Pi shutdown, top left corner, select shutdown, is wrong, like instant stop.

Why aren't settings saved properly when I close Opencpn? -due to Inland ECDIS is checked

Not saving settings when exiting -due to Inland ECDIS is checked

Always starts up with the Night Palette - due to Inland ECDIS is checked

Issue just started with 4.8.0 where on exit doesn't save * Units * Configuration of toolbar * Starts in night mode I searched the opencpn.ini for these settings but not sure what I am looking for TBH. I also backed up this file and exited the program forming a new ini file, same issue. Any ideas?

OpenCPN is probably set to use settings for Inland ECDIS European Inland Waterways ECDIS

Right-click > Navigate > To Here has a problem

The new Active Route always disappears and I try to recreate it and it disappears again.

How exactly does NMEA 0183 HDG Sentence work?

If HDG message also contains the variation and E/W flags then O will use that. If not then it will look in RMC message for a variation. If nothing there it will use WMM plugin unless user has selected the variation manually in options.

How do I save many waypoints to a Layer?

Question: Layers is a good feature, however I need a tool to create a layer with many waypoints (say 200 waypoints in Fiji). I'd like create a layer of all visible waypoints in a chart area that I have zoomed into. After creating the layer, I'd like to delete them from the waypoints list with a single command.

Answer: Using the Route & Mark Manager

How to join or combine two or more Routes into a Single Route?

  1. Mark the routes in the Route&Mark Manager, recording the order.
  2. Then export each route as a gpx file.
  3. Open the first file in a text editor.
  4. Open the next file in the text editor and copy the code between <rte> … </rte> not including them.
  5. Then paste the code directly before the </rte> at the end of the first file.
  6. Continue until done. Save the first file.
  7. Import the gpx file with a new name.

Why don't AIS and Watchdog Sound Alarms work on RPI?

Distorted sound

mpg123 -2 -m -w out.wav in.mp3 This is on a Raspberry PI using OpenPlotter 1.1.0 alpha)

No Sound in RPI:

RPI display errors

RPI 3B+ is running now for several hours with OpenCPN and chart open. No more locks ups or screen errors. VC4 driver on and in OpenCPN also OpenGL to on. Fast screen movements. Something seems to go wrong with the auto screen detection in OpenCPN. Use manual screen settings to set the proper display size. Back to kernel 4.14.62 ( 4.14.68 kernel and 4.14.69 and 67 seems to have also a memory leak) the system is runs all day without problems and with OpenGL switched on. Screen is an DVI with a conversion plug DVI > HDMI.

MAC OpenCPN seems to freeze. Why?

Going to Toolbar/Options/Plugins/Grib 4.1/Preferences; OpenCPN freezes when you check “Authorize interpolation to start at current time” (a warning first followed by a freeze requiring a “Force Quit” of the application).

How to Set Local Time

Set time to local for weather routing in view→settings. Set time to local for grib_pi in preferences.

How can I change my Ownship Icon?

A user can install his or her own icons to use with marks and “own ship”. See Install your own Icons “To replace the default own ship icon, red ship icon just put a file “ownship.xpm” or “ownship.png” in the UserIcons directory.”

ChartDownloader is missing

If you are using WindowsXP, it will not appear because WinXP does not support the encryption requiired. Sorry.

Opencpn.ini Options How to add boat position WP?

Add a Boat Position waypoint

[Settings]
SpaceDropMark=1

to the opencpn.ini file you get at the boat position every time you press the space-bar.

How to fix Ubuntu 18.04 Options Menu display anomyly?

See Moving Options Menu, shifts to and changes Opencpn Window-Min- Max in Ubuntu 18.04 #1787 A Desktop Manager workaround is required. Not possible to change behavior in OCPN.

For Ubuntu 18.04, Gnome desktop: One should install the package “Gnome Tweaks”, and change the setting “Windows→AttachModalDialogs” to OFF.

Function 'Filter NMEA/Course and Speed data' not honored if input thru Signal K

See #2292 If an NMEA 2000 GPS is connected and Signal K is used to read NMEA 2000 into OpenCPN the data will not honor the filter settings for NMEA/Course and Speed data. The course predictor will jump both in length and direction, not damped by the filter setting.

I can find also SOG/COG from SignalK data stream is passing the filter function. (by PostProcessNMEA()) But the filter function is by-passed if “Calculate SOG and COG from position changes” is enabled in Options→Ships→Own ship. Pls check. I was falling into that trap myself.

How to use XBox with OpenCPN